Superimposes one IconRef onto another.

OSErr CompositeIconRef (
    IconRef backgroundIconRef, 
    IconRef foregroundIconRef, 
    IconRef *compositeIconRef
);

backgroundIconRef

A value to use as the background for the composite IconRef.

foregroundIconRef

A value to use as the foregound for the composite IconRef.

compositeIconRef

On completion, this points to an IconRef that is a composite of the specified background and foreground IconRefs.

function result

A result code.

DISCUSSION

This function provides an alternative to badging when you need to indicate a change of state.

AVAILABILITY

Supported in Carbon. Available in CarbonLib 1.0 and later when IconServicesLib 8.5 or later is installed. Exported by CarbonLib 1.0 and later and by IconServicesLib 8.5 and later.

© 2000 Apple Computer, Inc. — (Last Updated 4/18/2000)